package com.qk.management.service;

import com.qk.common.PageResult;
import com.qk.domain.user.UserDO;
import com.qk.dto.user.UserDTO;
import com.qk.dto.user.UserLoginDTO;
import com.qk.entity.User;
import com.qk.vo.user.UserLoginVO;

import java.util.List;

/**
 *
 * @author MrZhao
 * @created 2025-10-07 18:15
 * @description 用户管理业务层接口
 *
 */
public interface UserService {
    /**
     *  用户登录
     * @param dto 登录参数
     * @return UserLoginVO 登录结果
     */
    UserLoginVO login(UserLoginDTO dto);
    /**
     *  修改用户
     * @param user 用户信息
     */
    void update(User user);
    /**
     *  根据id查询用户
     * @param id 用户id
     * @return User
     */
    User getById(Integer id);
    /**
     *  批量删除用户
     * @param ids 用户id列表
     */
    void deleteBatch(List<Integer> ids);
    /**
     * 根据角色查询用户
     * @param roleLabel 角色标签
     * @return List<User>
     */
    List<User> listByRole(String roleLabel);
    /**
     *  新增用户
     * @param user 用户信息
     */
    void add(User user);
    /**
     *  用户列表查询
     * @param dto 条件
     * @return PageResult<UserDO>
     */
    PageResult<UserDO> list(UserDTO dto);
}
